home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / libelfutil / xlate_get_info.z / xlate_get_info
Text File  |  1998-10-30  |  11KB  |  198 lines
  1.  
  2.  
  3.  
  4. XXXXLLLLAAAATTTTEEEE____GGGGEEEETTTT____IIIINNNNFFFFOOOO((((3333EEEE))))                                          XXXXLLLLAAAATTTTEEEE____GGGGEEEETTTT____IIIINNNNFFFFOOOO((((3333EEEE))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _xxxx_llll_aaaa_tttt_eeee______gggg_eeee_tttt______iiii_nnnn_ffff_oooo - get recorded overall info
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_eeee_llll_ffff_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_eeee_llll_ffff_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  16.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_mmmm_pppp_llll_rrrr_ssss_////_xxxx_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  17.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_XXXX_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  18.      _iiii_nnnn_tttt _xxxx_llll_aaaa_tttt_eeee______gggg_eeee_tttt______iiii_nnnn_ffff_oooo_((((_xxxx_llll_aaaa_tttt_eeee______tttt_aaaa_bbbb_llll_eeee______cccc_oooo_nnnn _cccc_oooo_nnnn______tttt_aaaa_bbbb_llll_eeee______pppp_tttt_rrrr_,,,,
  19.        _EEEE_llll_ffff_6666_4444______SSSS_xxxx_wwww_oooo_rrrr_dddd _****_dddd_aaaa_tttt_aaaa______mmmm_oooo_vvvv_eeee_dddd_,,,,
  20.        _EEEE_llll_ffff_6666_4444______AAAA_dddd_dddd_rrrr   _****_nnnn_eeee_wwww______llll_oooo_wwww______aaaa_dddd_dddd_rrrr_,,,,
  21.        _EEEE_llll_ffff_6666_4444______AAAA_dddd_dddd_rrrr   _****_oooo_llll_dddd______llll_oooo_wwww______aaaa_dddd_dddd_rrrr_,,,,
  22.        _EEEE_llll_ffff_6666_4444______AAAA_dddd_dddd_rrrr   _****_nnnn_eeee_wwww______hhhh_iiii_gggg_hhhh______aaaa_dddd_dddd_rrrr_,,,,
  23.        _EEEE_llll_ffff_6666_4444______AAAA_dddd_dddd_rrrr   _****_oooo_llll_dddd______hhhh_iiii_gggg_hhhh______aaaa_dddd_dddd_rrrr_,,,,
  24.        _EEEE_llll_ffff_6666_4444______AAAA_dddd_dddd_rrrr   _****_ssss_tttt_aaaa_rrrr_tttt_uuuu_pppp______ffff_wwww_aaaa_,,,,
  25.        _EEEE_llll_ffff_6666_4444______AAAA_dddd_dddd_rrrr   _****_ssss_tttt_aaaa_rrrr_tttt_uuuu_pppp______llll_wwww_aaaa_,,,,
  26.        _EEEE_llll_ffff_6666_4444______XXXX_wwww_oooo_rrrr_dddd  _****_nnnn_uuuu_mmmm_bbbb_eeee_rrrr______oooo_ffff______rrrr_aaaa_nnnn_gggg_eeee_ssss_,,,,
  27.        _iiii_nnnn_tttt          _****_oooo_llll_dddd______tttt_eeee_xxxx_tttt______eeee_xxxx_iiii_ssss_tttt_ssss_,,,,
  28.        _iiii_nnnn_tttt          _****_oooo_llll_dddd______tttt_eeee_xxxx_tttt______aaaa_llll_llll_oooo_cccc
  29.        _iiii_nnnn_tttt          _****_iiii_ssss_6666_4444_bbbb_iiii_tttt
  30.        _xxxx_llll_aaaa_tttt_eeee______tttt_aaaa_bbbb_llll_eeee_kkkk_iiii_nnnn_dddd _****_tttt_aaaa_bbbb_llll_eeee_kkkk_iiii_nnnn_dddd
  31.        _iiii_nnnn_tttt          _****_vvvv_eeee_rrrr_ssss_iiii_oooo_nnnn
  32.      _))))_;;;;
  33.  
  34. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.      _x_l_a_t_e__g_e_t__i_n_f_o is used to get basic values from the _x_l_a_t_e section.
  36.      _c_o_n__t_a_b_l_e__p_t_r must be a valid open translate table handle.  The other
  37.      arguments are pointers passed in and the pointers are used to put values
  38.      from the translation table header into the pointed-to data objects.  See
  39.      <_c_m_p_l_r_s/_x_l_a_t_e._h> for the header field declarations.  The memory that is
  40.      pointed to by the pointer is what is actually changed.
  41.  
  42.      Other than _c_o_n__t_a_b_l_e__p_t_r any of the pointers passed in may be the null
  43.      pointer (0).  _x_l_a_t_e__g_e_t__i_n_f_o notices each null pointer and does not
  44.      attempt to pass a value back thru a null pointer.
  45.  
  46.      _d_a_t_a__m_o_v_e_d
  47.              is the number of bytes the data section was moved by a
  48.              translation tool (normally only pixie(1) moves data sections).
  49.              The value is not the amount the text was moved but the amount
  50.              that the data had moved above and beyond text movement.  The
  51.              movement is important because _r_l_d(1) relies on the distance
  52.              between text and data being fixed.  The movement is an important
  53.              fact in the translation process but the fact is not ordinarily
  54.              needed by consuming tools or applications.
  55.  
  56.      _n_e_w__l_o_w__a_d_d_r
  57.              is set to the low pc address of the translated (runnable) text.
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. XXXXLLLLAAAATTTTEEEE____GGGGEEEETTTT____IIIINNNNFFFFOOOO((((3333EEEE))))                                          XXXXLLLLAAAATTTTEEEE____GGGGEEEETTTT____IIIINNNNFFFFOOOO((((3333EEEE))))
  70.  
  71.  
  72.  
  73.      _o_l_d__l_o_w__a_d_d_r
  74.              is set to the low pc address of the original (before translation)
  75.              text.
  76.  
  77.      _n_e_w__h_i_g_h__a_d_d_r
  78.              is set to the high pc address  (one past the last address
  79.              actually used) of the translated (runnable) text.
  80.  
  81.      _o_l_d__h_i_g_h__a_d_d_r
  82.              is set to the high pc address  (one past the last address
  83.              actually used) of the original (before translation) text.
  84.  
  85.      _s_t_a_r_t_u_p__f_w_a
  86.              is set to the pc address (First Word Address) (in the translated
  87.              text) of special startup code introduced by a translation tool.
  88.              _p_i_x_i_e is currently the only tool creating such special startup
  89.              code.
  90.  
  91.      _s_t_a_r_t_u_p__l_w_a
  92.              is set to the pc address (Last Word Address) (in the translated
  93.              text) of the end (actually one past the last address) of the
  94.              startup code introduced by a translation tool.  _p_i_x_i_e is
  95.              currently the only tool creating such special startup code.
  96.  
  97.      _n_u_m_b_e_r__o_f__r_a_n_g_e_s
  98.              is set to the number of ranges in the translation table.
  99.  
  100.      _o_l_d__t_e_x_t__e_x_i_s_t_s
  101.              is set to 1 if the original (untranslated) text is present in the
  102.              executable or DSO.  It is set to 0 if the original text is not
  103.              present.  _c_o_r_d(1)ed DSOs often do not have the original text
  104.              present.  _p_i_x_i_ed applications and DSOs usually do have the
  105.              original text present.
  106.  
  107.      _o_l_d__t_e_x_t__a_l_l_o_c
  108.              is set to 1 if the original text is present and is marked to be
  109.              brought into memory automatically on program startup.  Otherwise
  110.              _o_l_d__t_e_x_t__a_l_l_o_c is set to 0.  This lets a consuming application
  111.              (such as a debugger) know what it has to do to find the relevant
  112.              original text image.
  113.  
  114.      _i_s_6_4_b_i_t is set to 1 if the xlate file is marked as 64 bit (for a 64 bit
  115.              application).
  116.  
  117.      _t_a_b_l_e_k_i_n_d
  118.              is set to one of _x_l_a_t_e__t_k__g_e_n_e_r_a_l, _x_l_a_t_e__t_k__p_r_e_s_e_r_v_e__s_i_z_e, or
  119.              _x_l_a_t_e__t_k__p_r_e_s_e_r_v_e__o_r_d_e_r.
  120.  
  121.      _v_e_r_s_i_o_n is set to one of _X_L_A_T_E__T_B__M_A_I_N__V_1(1), _X_L_A_T_E__T_B__C_O_P_Y__V_1(2),
  122.              _X_L_A_T_E__T_B__D_E_B_U_G__V_1(3), _X_L_A_T_E__T_B__O_L_D__V_1(4), _X_L_A_T_E__T_B__3_2__V_2(5), or
  123.              _X_L_A_T_E__T_B__6_4__V_2(6).
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. XXXXLLLLAAAATTTTEEEE____GGGGEEEETTTT____IIIINNNNFFFFOOOO((((3333EEEE))))                                          XXXXLLLLAAAATTTTEEEE____GGGGEEEETTTT____IIIINNNNFFFFOOOO((((3333EEEE))))
  136.  
  137.  
  138.  
  139. FFFFIIIILLLLEEEESSSS
  140.      /usr/include/libXlate.h
  141.      /usr/include/cmplrs/xlate.h
  142.      /usr/include/elf.h
  143.      /usr/include/dwarf.h
  144.      /usr/include/libdwarf.h
  145.      /usr/lib/libelfutil.a
  146.  
  147. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  148.      Returns XLATE_TB_STATUS_NO_ERROR (0) on success.  In case of error, a
  149.      negative number is returned indicating the error.  In case of error,
  150.      nothing is returned thru the pointer arguments which would return values
  151.      on successful call (values might have been changed thru these pointers
  152.      but any such changes are not meaningful).
  153.  
  154.      _X_L_A_T_E__T_B__S_T_A_T_U_S__I_N_V_A_L_I_D__T_A_B_L_E
  155.              The initial bytes of the structure pointed to by
  156.              _c_o_n_s_u_m_e_r__t_a_b_l_e__p_t_r have been corrupted (indicating _m_a_l_l_o_c(3)
  157.              arena corruption) or the pointer is not pointing to a valid open
  158.              consumer table.
  159.  
  160. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  161.      libelfutil(5), open(2), xlate(4), xlate_init_fd(3e), xlate_finish(3e),
  162.      xlate_pro_init(3e), xlate_pro_finish(3e), xlate_pro_add_info(3e),
  163.      xlate_address(3e)
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.